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performed at the request of the Flight Vehicle Branch, Aeromechanics 
Division, Air Force Flight Dynamics Laboratory, Wright-Patterson 
Air Force Base, Ohio under Project Number 2404-16-02 during the 
period from November 1977 to February 1978. The author was Jerry 
G. Jensen with contributions from Dr. Duane G. Leet. The Project 
Engineer was James L. Terry. 


Computer programs described in this report were written by 
personnel from the Digital Programming Branch, Digital Processing 
Division, Air Force Aeronautical Systems Division Computer Center, 
Wright-Patterson Air Force Base, Ohio. Systems analysis was per- 
formed by Thomas S. Rowland. Programmers were Sharon J. Foley, 
Capt. Stephen E. Hamm, and Wayne A. Jansen. 
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SUMMARY 


This report describes a system of digital computer programs 
called PLUGO (Plotting Language Utilizing Graphical Optics). This 
report is contained in two volumes - Volume I, PLUGO User's Guide; 
and Volume II, PLUGO System Description. The PLUGO systems con- 
sists of two phases. Phase I is a batch program that scans the 
input data tape, captures data points, and creates plots from these 
points. Phase II is an interactive graphics program that permits 
the user to modify and analyze the plots created by Phase I. The 
PLUGO programs are written in CDC FORTRAN EXTENDED and are designed 
to execute on a CDC 6600 or CYBER 74 computer system. 


Basic input to PLUGO is a sequential file containing any 
number of fixed format data records (data points). Each data point 
may contain floating-point values for up to 100 experimental vari- 
ables. Output consists of X-Y plots, drawn on a Calcomp plotter 
of data subsets from the input data file. The user defines condi- 
tions on the experimental variables that determine how the data 
points are grouped into these subsets. The resulting plots are 
subject to modification through the use of an interactive-graphics 
program executed at a CDC CYBERGRAPHICS CRT terminal. 


Modification functions include: 


Curve-fitting - Data points on the plots may be curve-fitted 
using a straight-line, least squares, or 
spline algorithm, 


Editing Data points may be added to or deleted from 
the plots. 


Interpolation Data values may be calculated from the co- 
efficients calculated by the curve-fitting 
functions. 


Trimming Trimmed plots of wind-tunnel generated force- 
moment data may be obtained. 


Plot 
Information Listings of plot information (data point values, 
curve-fit coefficients, etc.) may be obtained. 


Thus PLUGO provides the user with a powerful yet simple to 
use data analysis tool capable of handling large amounts of data. 
in an efficient manner. 
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SECTION I 
INTRODUCTION 


This document is intended to provide the programmer with 


general information regarding the mechanics of the PLUGO Phase I 


and Phase II programs. Information about overlay structures, file 


communication, libraries, and non-standard programming techniques 


is included in the text. Specific remarks pertaining to variable 


usage and to specific logic used within individual routines are 


provided by COMMENT cards included within the Phase I and Phase II 
source code listings. 


Due to the size and complexity of these programs, the PLUGO 
system is maintained by personnel at the ASD Computer Center. Thus 
questions pertaining to program modifications, malfunctions, status, 
etc., should be directed to Sharon Foley, ASD Computer Center, 
Building 676, Wright-Patterson Air Force Base, Ohio. 





SECTION II 
SYSTEM DESCRIPTION 
\ 


Figure 1 illustrates the flow of data through the PLUGO sys- 
tem. The PLUGO system consists of two FORTRAN programs - Phase I 
and Phase II. Input to Phase I consists of three files - 


OLDPL Source Code File - This file contains the source code 
for the Phase I program. It is suggested that this 
file be stored on magnetic tape or disc, however 
cards could also be used. It must be in OLDPL 
(UPDATE) format (Reference 1). 


PLUGO Input Tape - A detailed description of this file may 
be found in the PLUGO USER'S MANUAL. 


Phase I Input Deck - A detailed description of this file may 
be found in the PLUGO USER'S MANUAL. 


Successful execution of PLUGO Phase I produces the following three 
files - 


Phase I Plot Tape - This file contains the plots produced by 
the Phase I program. This tape may be plotted on 
an off-line Calcomp plotter. 


Graphics Disc File - This file also contains the plots 
created by the Phase I program. This file is used 
as input to the Phase II program. The format of 
this file is consistant with the CDC INTERACTIVE 
GRAPHICS package (Reference 2). 


Plot Data and Dayfile - Described in the PLUGO USER'S MANUAL. 


Input to the Phase II program consists of the following files - 


PLUGO Accounting File - This is a permanent disc file that 
contains a record of PLUGO Phase II usage. The 
date, time, and CPU seconds used for each session 
are recorded in this file. 
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Graphics Disc File - This file contains data pertaining to 


the plots to be displayed by the Phase II program, 
This file may be the one created by the Phase I 
program or one created by the Phase II program. 


Execution of PLUGO Phase II results in the user modifying 

the plots on the input Graphics Disc File, All new plots, modified 
plots, and original plots are written to a new Graphics Disc file. 
Upon termination of Phase II the following files are output, 


PLUGO Accounting File - A new record containing the date, 


time, and CPU seconds used for the just completed 
session is added to this file. 


Plot Data - This file is optional. A description of this 


Graphics 


Hardcopy 


listing is described in the PLUGO USER'S MANUAL. 


Disc File - This file reflects the state of all 
available plots at the time the Phase II program 

was terminated. That is, all plots and their 
modifications (added points, curve-fits, cross plots) 
that were available to the user upon termination 

of Phase II are saved on this file. This file may 


‘be used as input to Phase II thus allowing the user 


to resume the session. This file is an optional 
output. 


Data File and Batch Job File - These two files are 
closely related. When the user specifies the HARD- 
COPY option during a Phase II session, the plot cur- 
rently displayed on the screen is written to the 
Hardcopy Data File. Upon termination of a Phase II 
session, this file is cataloged as a permanent sys- 
tem file. Also at this time the PLUGO system, 
sensing that Hardcopy plots have been saved, releases 
a batch job to the computer's input queue. When 
this batch job is executed the following will occur. 
The job will attach the Hardcopy Data File that has 
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been cataloged. The specified Phase II Plot Tape 

is then requested. When this tape is mounted the 

job will copy the Hardcopy Data File to the Phase 

II Plot Tape. Finally, the Hardcopy Data File is 

purged from the system. The dayfile from this job 
signifies that the Phase II Plot Tape is ready to 

be plotted. 


The Phase I and Phase II programs aye written in CDC FORTRAN EX- 
TENDED (Reference 3). 
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SECTION III 
SOFTWARE CONSIDERATIONS 


Table 1 contains the various libraries used by PLUGO. Two 
of these (IGS777 and CCPLOT) are used directly by the Phase I pro- 
gram. The Phase II program utilizes all of them; however, they 
do not appear in the CCL catalogued procedure. The reason is that 


the libraries are included with the Phase II object code in the 
PTASK file. 


The PLUGO system was originally written for a 274 Interactive 
Graphics System (Reference 3). The system has been modified (up- 
date ident CYB777) to make it compatible with the 777 Interactive 
Graphics System. These modifications involve changing the initial- 
ization calls to the Data Manager and establishing an end-of- 
message character. PLUGO runs under a 274 emulator package con- 
tained in the IGS777 library. Therefore, PLUGO can run on a type 
777 Cybergraphics terminal or, with a few modifications, on the 
older 274 terminal. 





TABLE 1 
LIBRARY FILES USED BY THE PLUGO SYSTEM 


Library Name Routine Purpose 


IGS777 Graphics routines Used to build and read the 
Graphics Disc File and to 
display plots on the Cyber- 
graphics terminal. 


CCPLOT Calcomp routines Used to create the Calcomp 
plot tapes. 


CC6600 "STRING" String manipulation routine. 


NOSLIB "PERMFIL" Automatic permfile attach, 
extend, and return. 


DRIVER DMP, DMPX, RCOVER Error recovery routines. 
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SECTION IV 
THE PHASE I PROGRAM 


4.1 FILES 


<a th 


The following files are used by the Phase I program. 
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FILE TYPE 
TAPE5 INPUT 
TAPE6 OUTPUT 
TAPE7 PLOT 
TAPE3 PLUGO Input Tape 


The record format for TAPE5 and TAPE6 is standard. Record 
format for TAPE7 is unnecessary since the Calcomp plotting soft- 
ware takes care of this. The TAPE3 record format is read off cards 
in the Phase I Input Deck. It is necessary to specify this record 
length in the PROGRAM statement of the Phase I program (refer to 
the Update Section in the PLUGO USER'S GUIDE). The Graphics Disc 
File is not directly specified in the Phase I program. Use of this 
file and how it is accessed by the Data Manager routines within 
the Phase I program is described in the CDC INTERACTIVE GRAPHICS 
MANUAL (Reference 2). 


4.2 PHASE I PROGRAM STRUCTURE AND FUNCTION 


The Phase I program uses overlays to reduce the central memory 
requirement necessary for execution. The program consists of a 
Nucleus (0,0 overlay) and six level 1 overlays (Figure 2). Each 
overlay performs a specific function within the program. The level 
1 overlays are called in order ((1,0) through (6.0)). Each level 
1 overlay is called only once, thus the following description of 
the overlays will describe the algorithm used by the Phase 1 program. 


Nucleus (0,0 overlay) - This overlay drives the other overlays. 
It also contains error detection routines and routines 


common to other overlays. The main function of this 


overlay is to call the other six overlays. 
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This overlay contains various initialization routines 
such as the one used to rename the default element 
names (OLD=V1l NEW=XXX). 


This overaly reads in the CSS Table from the front 
of the PLUGO Input Tape. 







This overlay reads and edits the Plot Specification 
cards. The plot structures are formed from these 
cards. 













This overlay reads the PLUGO Input Tape and selects 
Data Points from it in accordance to the Plot Speci- 
fication cards. The calculated values and user de- 

fined functions are located in this overlay. 


This overlay separates the selected Data Points into 
the various specified plot structures. 


















This overlay accumulates statistics, creates the 
plots and writes them to the Phase I Plot Tape and 
i Graphics Disc File, and generates the Plot Data 

listing. 





The usage of variables and the functions of individual sub- 
routines is described by COMMENT cards throughout the Phase I source 
code listing. 







4.3 PHASE I PROGRAM LISTING 


See Appendix A. 
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5.1 INITIATION OF THE PHASE II PROGRAM 


- PLUGO Phase II is initiated by executing a Cyber Control 
Language (Reference 4) cataloged procedure (Figure 3). This pro- 
cedure is stored on the permenent file PROCFIL. Depending on what 
problem number the user has logged in under, it may be necessary j 
to attach the permanent file on which the cataloged procedure 
resides. This file should be attached using a local file name of 

! PROCFIL. An example on the A system would be - ATTACH, PROCFIL, 

PROCFIL, ID=A730528, SN=ASD, MR=l1. An example on the B system 

would be - ATTACH, PROCFIL,, PROCFIL, ID=D740020, SN=AFFDL, MR=1. 

| The Phase II object code and necessary library modules are stored 

et 


de hates has er ts 


ee eee 


on the permanent file PTASK. The PLUGO Accounting File is stored 
on the permanent file PLUGOABS. 


5.2 PHASE II FILES 
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The following files are used by the Phase II program: 


FILE TYPE 

TAPE6 OUTPUT 

TAPE43 PLUGO Accounting File (Input/Output) 
TAPE99 HARDCOPY FILE (Output) 


TAPE6 is used to output the PRINT PLOT INFORMATION listing. 
The TAPE6 buffer size is declared in the PROGRAM statement to be 
64 octal words. TAPE43 also uses a 64 word buffer. A TAPE43 
record contains the record number, date, time, and CPU time used. 
The record format is (1X, I5, 4X, Al0, 5X, Al0O, 5X, F10.2). Figure 
4 is a sample of the data stored in TAPE43. 
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-PROC>PLUGO> DMN? Cys DPB=A730528> TID=ABsFID=PLUs TAPE> TPBs HC=PLU, 


IFEs SW1> JUMPS. 

SWITCH: 1. 

ENDIF» JUMPS. 

RFL: 75500. 

ATTACH: TASK s PTASKs ID=A730528s SN=ASD. 

ATTACH: TEMPFLs DMN> #CY=C's ID=DPB. 

COPYBFs TEMPFL» DMFILE. 

RETURN: TEMPFL. 

REWIND: DMFILE. 

REQUEST» TAPES9s PF. 

ATTACH: TAPE43>» PLUGOABSs Plu=SJFs ID=A730528s SN=ASD. 
LIBLOAD<TASKs STARTER? 

EXECUTE. 

IFEs SW1s JUMP1. 

REQUEST» NEWs PF. 

REWINDs DMFILE. 

COPYBF> DMF ILE: NEW. 

CATALOG: NEWs DMN» RP=999> ID=DPB. 

SKIPs JUMP 1. 

EDIT ¢S> 

ENDIF, JUMP1. 

RETURN» NEbls DMF ILE: TRPE43s TASK. 

CATALOGs TAPE99>HC> ID=A730528. 

SKIPs JUMP2. 

EXITsS. 

SKIP»sNOPLOT. 

ENDIF» JUMPe. 

RETURN: TAPE99. 
ROUTEsPLUGOHCs ¢TID=TIDs ef LO=F IDs DC=INs ST=CSB. 
ENDIFsNOPLOT. 

RETURN: TAPES9. 

ROUTEs TAPES: DC=PR» ST=CSAseTID=TIDs #FID=FID. 

- DATA PLUGOHC 

FIDsCM100005MT1:T10,;1I0200. TPBs PLUGO CALCOMP 
COMMENT. * * INTERCOM JOP: NO DECK ¢ # # 
ATTACH: OLDsHC>s ID=A730528. 

LABEL: NEW: lls L=PLUGOHARD: YVSN=TAPE>RING. TPBs TTY 
COPYBFsOLD> NEW. 

PURGE» OLD. 

EXITsU. 

ROUTE> OUTPUT, DC=PRs #TID=TIDs #FID=FIDs DEFs ST=CSA. 


Figure 3. The Cataloged Procedure Used to Initiate 
PLUGO Phase II 
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1 10/25/77 09.50.50. 22.95 
2 11701777 09.12.38. 2.99 
3 11701777 13.29.12. 10.07 
4 11/02/77 09.45.27. 10.93 
5 11/03/77 09.42.13. 1.37 
é 11/08/77 10.48. 05. 1.32 f 
7 11708777 15.09.53. 7.64 
=) 11710777 12.46.50. 34 y 
9 11710777 13.19.17. 14.48 
10 11/10/77 14.13. 06. 2.43 ' 
11 11711777 09.27.31. 1.59 i 
12 11714777 14.52.21. 72.28 { 
13 11714777 16.14. 08. 1.20 ' 
14 11/15/77 08.34.58. 4.65 
15 11/16/77 09.4 .14. 1.90 
16 1171677 10.16.59. 5.33 
17 11716777 14.21.05. 43.20 
138 11716777 15.26.11. 3.16 
19 11717777 14.26.24. 29.33 
20 11717777 14.32.43. 1.39 
21 11/18/77 16.20.16. 35.28 
22 11/21/77 10.08.11. 2.34 
23 11721/77 12.48.50. 6.59 
24 11/22/77 09.42.28. 5.47 
25 11/22/77 11.01.51. 3.00 
26 11/22/77 14.30.02. 36 
27 1123/77 13.57.44. .39 
23 11/28/77 09.27.54. 9.49 
29 11/29/77 14.05.11. <3? 
30 11/30/77 09.59.46. 35 
31 11/30/77 10.02.10. 35 
32 11/30/77 10.20.23. 9.53 
33 12/01/77 12.55.54. 13.01 
34 12/05/77 10.29.05. 7.12 
35 12709777 16.07.41. 36.72 
36 12713777 13.17.20. 11.32 
37 12/15/77 09.34.56. 32 
33 12719777 09.23.28. 2.56 
39 12719777 09.53.45. 4.34 
40 12719777 10.21.45. 232 
41 12719777 10.35.07. 2.66 
42 12719777 10.45.40. 9.06 
43 12720777 15.16.37. 1.31 
44 12720777 15.43.41. 11.30 
45 12721777 09.06.02. 9.39 
46 12/21/77 09.17.55. 5.06 
47 12/21/77 13.42.39. 12.56 
43 12721777 14.09.10. 3.15 
49 12721777 14.16.09. 5.32 
50 12/21/77 15.30.55. 12.72 
51 12/22/77 10.03.02. 5.20 
52 12722777 10.44.35. .33 


Ae 





Figure 4. Record Number, Date, Time of Day, and CPU 
Seconds Used, as Stored in the PLUGO 
ei Accounting File 
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5.3 PHASE II PROGRAM STRUCTURE AND FUNCTION 


Figure 5 illustrates the overlay structure of the Phase II 
program. Unlike the Phase I program, the Phase II overlays are 
loaded into core depending on which function the user is currently 
using. 


Transfer between overlays is done with the AETSKC and AERTRN 
routines. The AETSKC routines is similar to a CALL function but 
is unique in that it can call another overlay without going through 
the (0,0) overlay. The AERTRN is a RETURN to the calling AETSKC. 


Usage of variables and functions of individual subroutines 
is described with COMMENT cards throughout the source listing. 


5.4 PHASE II PROGRAM LISTING 


See Appendix B. 
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